home *** CD-ROM | disk | FTP | other *** search
/ Mac Mania 6 / MacMania 6.toast / / Tools&Utilities / TouchMe 1.2□ / touchMe 1.2 Folder / touchMe 1.2 readme < prev    next >
Text File  |  1997-04-25  |  11KB  |  176 lines

  1.  
  2. touchMe 1.2 (April 25, 1997)
  3. Copyright ©1994-1997 Mizutori Tetsuya
  4. This program is freeware.
  5.  
  6. About the touchMe program
  7. This is an application program to update the creation and/or modification date time stamp on Macintosh files or folders. It is like Unix command “touch”. To run the program, it requires System 7.1 or later. Under System 7.5, touchMe is also AppleScriptable and allows the drag and drop operations. The program is written under the Metrowerks’ C++ application framework of PowerPlant.
  8.  
  9. Why is touchMe needed?
  10. I have been using this program for these years in private to update the right date time stamps on the archive files that I have downloaded. The reason I want to change the date time stamp is that the archive files can have the correct date time corresponding to their original files. There may be a way to do this with ResEdit, but using touchMe is more practical.
  11.    CASE 1. If both archive file and original file are residing in the same folder. To update the date time stamp on the archive file by the original one, select both files, but the original file be first, then drag and drop them onto the touchMe application icon (or window area).
  12.    CASE 2. If these files are located in the different folders or volumes. touchMe will also provide you with a nice tip to update the date time stamp. First, open the touchMe application to fill in its date time columns by the date time stamp on the original file. Next, select the other archive file and drop it onto the touchMe application icon (or window area).
  13.  
  14. How do you use it?
  15. First of all, you should setup the optional switches of the touchMe program, which are listed below;
  16.  [x] Update the creation / modification date
  17.   • by the current date time
  18.   • to [exact date time]
  19.   • by the first item you selected
  20.   • by the first, and fill in columns
  21. These settings are automatically stored to the touchMe preferences file when you quit by the “OK” button.
  22.      Second, select and drop the files or folders onto the touchMe application icon. Under System 7.5 running, you can also drag and drop them onto the touchMe window area (which will indicate it by hiliting the border of the window). Then all the files you selected will have the same date time stamp, which you can confirm by Finder’s “Get Info” command.
  23. TIPS: With the shift-key pressed during the operation, it will open Get Info for the selected items.
  24.  
  25. How do the switches work?
  26.   • by the current date time
  27.      All the date time stamp on the files or folders that you selected are set to the same value, which takes the current date time.
  28.   • to [exact date time]
  29.      Enter the date time, like as “8/1/96” or “August 1, 1996” for date and “12:34:56” for time. There are four ways to fill in the date time columns as follows.
  30.      1) Hold down the control-key (or option-key) when you select the “Open...” menu command. This mode will be indicated by showing a tiny mark at the top-left corner of the window. Then the date time stamp is fetched from the selected file or folder, and it will be put in the columns.
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.      2) Type in the date time strings. Please be careful to write them in a right date time format. If your system is 7.5 or later, you are allowed to drag and drop the date time string to fill in the columns. As a general rule, it will be cut if you drop the text string onto the Finder’s trash icon.
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.      3) Press the small button at the top-right corner on each column to setup the present time. With the option-key pressed, the time part of the column will be cleared to zero, that means a midnight.
  51.      4) Under System 7.5, hold down the command-key (or option-key) while you drag the file (or folder) and drop it on the touchMe window area. When the dragged item has entered in the window area, all the columns are hilited to indicate that they are accepting the file to fetch its date time stamp. In particular, you can fill in each column separately by dragging it on a particular column.
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.   • by the first item you selected
  62.      touchMe can fetch the date time stamp from the ‘first’ item among the files (or folders) you selected. Well, what does it mean the ‘first’? It may vary on the conditions by which view you open the Finder’s folder.
  63.      1) View by Small Icon or Icon: The first item is the one you have selected first. You may choose additional files or folders as the followers by clicking them with the shift-key.
  64.      2) View by Name, Size, Kind or Date: The first item is the one which is listed at the topmost position in the listings. The order may not be changed even if you choose the items at random by selecting with the shift-key.
  65.   • by the first, and fill in columns
  66.      It works like above, but additionally fills in the date time columns by the first item you selected. 
  67.  
  68. AppleScript commands
  69. Required Suite:
  70.     open  alias   -- touch the items
  71.     print  alias  -- (do nothing)
  72.     run     -- Sent to an application when it is double-clicked
  73.     quit    -- Quit application
  74.  
  75. touchMe Suite:
  76.  get prefs creation/modification -- get the current settings
  77.    Result:   prefs  -- list of current settings
  78.  set prefs creation/modification to prefs -- set the new settings
  79.  load prefs  -- load the settings from the preferences file
  80.  save prefs  -- save the settings to the preferences file
  81.  touch  alias  -- touch the items
  82.  fetch  alias  -- fetch the item, and set the date time settings
  83.    Result:  time stamp -- list of creation and modification date time
  84.  
  85. Class prefs: Settings information
  86. Properties:
  87.  enabled  true/false
  88.  flag  current/exact/firstone/firstset
  89.  value  date value
  90.  
  91. Class time stamp: creation and modification date time
  92. Properties:
  93.  creation date  date value
  94.  modification date  date value
  95.  
  96. Example: A droplet to change the creation date to the current date, and the modification date according to the first file
  97. on open (docList)
  98.   tell application "touchMe"
  99.     set theDate to current date
  100.     set xDate to date "8/1/96 12:34:56"
  101.     set prefs creation to {enabled:true, flag:exact, value:theDate}
  102.     set prefs modification to {enabled:true, flag:firstone}
  103.     touch docList
  104.     quit
  105.   end tell
  106. end open
  107.  
  108. Revision history
  109. • v.1.2, published on April 25, 1997
  110.  - New. The modifier-key operation was changed. To touch the files, just put them onto the application icon or the touchMe window. To fill in the date time columns, please drag and drop the file or folder over the columns with the command-key pressed.
  111.  - Bug. It sometimes failed to hilite the border of touchMe window when you drag the files with command-key pressed. Fixed for sure!
  112.  - New. The text strings can be put shortly in the date time columns even if you do not hold down the command-key or option-key.
  113.  - Bug. The indicator (*) for holding modifier keys was flickering unsteadily on the top-left corner of the window. Fixed.
  114.  - New. Corrected the right captions of check boxes and radio buttons for the readability.
  115.  - New. The design of the Apple Guide file was improved. It now starts to open the topics list window, instead of browing every panel in sequence from the first. The previous version of the styled help board was discontinued.
  116.  - New. The software is now constructed from a bunch of reusable codes, which forms a class library common to my “puriTEXT” program.
  117.  
  118. • v.1.1.2, published on February 10, 1997
  119.  - New. You can now use a drag operation on the text string to fill in the date time columns.
  120.  - New. For AppleScript commands “touch” and “fetch”, they are now accepting both a single file or a list of files equally.
  121.  - New. With the option-key pressed, the Set-Present-Time button will clear the time part of the columns, so that a midnight time will be entered.
  122.  - Bug. It sometimes failed to hilite the border of touchMe window when you drag the files with the option-key pressed. Fixed it, I hope.
  123.  - New. The C++ compiler was changed to CW11 from CW9 of CodeWarrior PowerPlant. Due to the changes on LApplication class, I have to update my CHelpMenu class to enable the “Help touchMe” item of the help menu.
  124.  - New. Added an Apple Guide file. I hope this guide file will be of much help to you.
  125.  
  126. • v.1.1.1, published on August 8, 1996
  127.  - New. During a drag and drop operation with the option-key pressed, the command “touch” and “fetch” are exchanged temporarily with each other.
  128.  - New. All the date time columns are now sensitive to accept the dragging files separately.
  129.  - New. It remembers the last position of the window on quit by the “Cancel” button as well as “OK”.
  130.  - Bug. A well-known (but, I didn’t know:-) MacOS bug on using the colored alert boxes is fixed. Thanks to Rokkaku Fumio who pointed out this problem with a nice solution.
  131.  - New. Enabled the “Close Box” in the window title that works as the “Cancel” button, and also enabled the help menu item which will appear in the desktop menu bar.
  132.  - New. Added many practical samples for AppleScript scripting works.
  133.  - Bug. Corrected a typo, a wrong file name for “touchMe Prefs”.;-)
  134.  - Special thanks to Jim van Zee who has always encouraged me in this project and made many cool suggestions to work around the problems.
  135.  
  136. • v.1.1, published on August 1, 1996
  137.    All the programs were rewritten for the Metrowerks’ C++ application framework PowerPlant of CodeWarrior CW9. This is the first release of the renewal version.
  138.  
  139. • v.1.0, first released on March 9, 1994
  140.    The first version of the program, originally written in Symantec’s THINK-C.
  141.  
  142. The package includes...
  143.    1. touchMe              -- application programs for 68K and PowerPC
  144.    2. touchMe Guide    -- an Apple Guide file
  145.    3. touchMe readme  -- just this file you are reading
  146.    4. touchMe scripts  -- sample AppleScript code using with touchMe
  147.    5. touchMe source   -- source code in CodeWarrior 11 PowerPlant
  148.    6. touchMe Guide source   -- source code of Apple Guide file
  149.    7. Apple Guide SharedLibs  -- for PowerMacs without Apple Guide
  150. This is a freeware program. You can distribute it without any limitations nor permissions.
  151.  
  152. About the Author
  153. If you have any questions, remarks or problems, please feel free to contact me via e-mail;
  154.    <mailto:mizutori@po.iijnet.or.jp>
  155.    <mailto:mizutori@ai.rcast.u-tokyo.ac.jp>
  156.  
  157. The latest versions of my software are available at my following WWW page;
  158.    <http://www.bekkoame.or.jp/~mizutori/software/catalog.html>
  159.  
  160. Today’s words
  161.  
  162.     Time n. 
  163.     A nonspatial continuum 
  164.     inwhich events occur in 
  165.     apparently irreversible 
  166.     succession from the past 
  167.     through the present to 
  168.     the future. 
  169.     [from QuickTime 
  170.            by Apple Computer]
  171.  
  172.  
  173. --
  174. Mizutori Tetsuya, Tokyo, Japan
  175. mizutori@po.iijnet.or.jp
  176.